home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr05 / todo102.zip / FM_UTL11.ZIP / FM_UTILS.TXT < prev   
Text File  |  1992-08-15  |  4KB  |  95 lines
  1. //***************************************************************************
  2. //
  3. //    Library:
  4. //      FM_UTILS.DLL - version 1.1a
  5. //
  6. //    Purpose:
  7. //        FM_UTILS is a File Manager extension DLL. An extension DLL adds
  8. //        a menu to File Manager, contains an entry point that processes menu
  9. //        commands and notification messages sent by File Manager, and
  10. //        queries data and information about the File Manager windows. The 
  11. //        purpose of an extension DLL is to add administration support 
  12. //        features to File Manager, for example, file and disk utilities.
  13. //        Up to five extension DLLs may be installed at any one time.
  14. //
  15. //        FM_UTILS adds a menu (called "Utilities" by default) to File Manager
  16. //        and processes all the messages that are sent by File Manager to an 
  17. //        extension DLL. In order to retrieve any information, it sends 
  18. //        messages to File Manager.
  19. //
  20. //    Usage:
  21. //        File Manager installs the extensions that have entries in the 
  22. //        [AddOns] section of the WINFILE.INI initialization file. An entry 
  23. //        consists of a tag and a value. To load FM_UTILS.DLL as a File 
  24. //        Manager extension, add the following to WINFILE.INI (assuming the 
  25. //        DLL resides in c:\win\system):
  26. //
  27. //            [AddOns]
  28. //            FM_Utils Extension=fm_utils.dll
  29. //
  30. //        In addition, a section specific to this Extension DLL is added to
  31. //        WINFILE.INI. There are several elements to this section:
  32. //        For each utility to appear on the menu, there is a 'UserProgn=' tag,
  33. //        and a 'UserDescn=' tag. Comments (preceded by semicolons) are optional.
  34. //        You may have up to twenty separate utilities specified.
  35. //        You can also specify up to five utilities to load at the same time as
  36. //        FileMan, and exit when you close FileMan. You use the 'PreLoadn='
  37. //        tag for this. All of the utilities are started with the SW_SHOWMINNOACTIVE
  38. //        setting (minimized, but not activated).
  39. //        And, you can specify the name of the added menu. If you choose not to,
  40. //        the default is "&Utilities". This provides foreign language support,
  41. //        as well as allowing you to use a very short name, to keep the menu bar
  42. //        from growing too long. The tag to use is 'UserMenuName='.
  43. //
  44. //            [FM_Utils Extension]
  45. //            ;Name the menu
  46. //            UserMenuName=&Util
  47. //            ;add Upper Deck Editor to menu
  48. //            UserDesc1=&Edit File(s)
  49. //            UserProg1=D:\UDE\UDE.EXE
  50. //            ;add V. Buerg's LIST to menu
  51. //            UserDesc2=&View File(s)
  52. //            UserProg2=LIST.PIF
  53. //            ;PreLoad Trash Can
  54. //            PreLoad1=TRASH.EXE
  55. //
  56. //    Revision History:
  57. //        1.0 - March '92 - initial release
  58. //
  59. //        1.1 - April '92 - added ability to PreLoad utilities. This seems even
  60. //                            more popular than the original DLL.
  61. //
  62. //        1.1a - August '92 - added ability to specify menu name; changed
  63. //                            SendMessage(...WM_CLOSE...) to PostMessage(...WM_CLOSE...)
  64. //                            since it seemed to make more sense.
  65. //
  66. //    Notes:
  67. //        Portions of the base code for this utility is based on, and borrowed
  68. //        from, the XTENSION sample code provided with the Microsoft Windows
  69. //        3.1 SDK.
  70. //
  71. //        FM_UTILS attempts to close any auto-started utilities by posting a
  72. //        WM_CLOSE to it's main window. There's no guarantee that this method
  73. //        will work for *all* programs. If you know of a better way to handle
  74. //        this situation, I'd be *really* happy to hear about it.
  75. //
  76. //        While it's not properly documented anywhere, it seems that the maximum
  77. //        command line to pass to WinExec() is 128 characters. Since we have to
  78. //        pass in complete pathnames for all files in order for this to work,
  79. //        we may not be able to pass *all* selected file names.
  80. //
  81. //    Copyright (c) 1992 by Brad P. Smith - all rights reserved
  82. //
  83. //        snail:    R.R. #2 - 777 Crozier Rd.
  84. //                Oxford Mills, Ontario, CANADA
  85. //                K0G 1S0
  86. //        E-Mail:    'B.P.Smith' on BIX, or 'smithb@cognos.com' on Internet
  87. //
  88. //        This utility DLL is FreeWare. Don't let *anybody* charge you
  89. //        for it.
  90. //        However, I would *really* appreciate hearing from you if you find
  91. //        FM_UTILS useful. Drop me a postcard or E-mail. I could use the moral
  92. //        support. :-)
  93. //
  94. //***************************************************************************
  95.